home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / gateway2.zip / GATEWAY2.DOC < prev    next >
Text File  |  1987-07-16  |  13KB  |  268 lines
  1.  
  2.   ******
  3.  ********    ****    ********  ********                       ****   ***    ***
  4.  **    **   **  **   ********  **    **  ***           ***   **  **   ***  ***
  5.  **        **    **     **     **        ***           ***  **    **   ******
  6.  **   ***  **    **     **     *****      ***    *    ***   **    **    ****
  7.  **    **  ********     **     **          ***  ***  ***    ********    ***
  8.  ********  **    **     **     **    **     ***********     **    **   ***
  9.   ******   **    **     **     ********      ***   ***      **    **  ***
  10.  
  11.  
  12.           GATEWAY (c) version 2.00  -  July 1987 by Hans D. Kellner
  13.  
  14.  
  15.         Welcome to  Gateway and the  world of remote communications!  This
  16.     program has been written as a utility for System Operators (Sysops) of
  17.     bulletin boards.  It is now possible to run an external program and be
  18.     able to control and see the program, even if the program uses the ANSI
  19.     control codes.  Input is taken  from the COM line and system keyboard.
  20.     Output is  sent to  the system  screen and out  through  the COM line.
  21.     Several new features have  been added to version 2.00 of Gateway.  The
  22.     most important  is the  support of a Fossil  driver  for input/output.
  23.     Also, the program is now  one file that is installed with command line
  24.     arguments.  A  few other changes  have been  added which are explained
  25.     below.  Now enough chatter...  go on to the good stuff!
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                              SYSTEM REQUIREMENTS
  34.                              -------------------
  35.  
  36.         Gateway has been  written in  assembly language as a DOS character
  37.     device  driver.  When loaded,  it only  requires a  little  over 2K of
  38.     memory.  It may be run on an IBM PC or compatible using PC/MS DOS.  If
  39.     the Fossil driver option is used  the program is less dependent on the
  40.     hardware.  When the  Fossil option is  specified all COM  input/output
  41.     and keyboard input is done through the  Fossil.  If direct port writes
  42.     are used, COM input/output is done with direct read/writes to the 8250
  43.     UART chip.   Also, keyboard  input will be done through BIOS call 16H.
  44.     In  both  options, screen  output  is done  through BIOS call 10H.  If
  45.     you  have installed  Gateway  with the  Fossil option,  then a  Fossil
  46.     driver  must be loaded  before  Gateway may be used.  Two drivers that
  47.     have been tested with Gateway are X00 by Ray Gwinn and OPUS!COM by Bob
  48.     Hartman.  Other Fossil  drivers may work with  Gateway as long as they
  49.     implement the same functions.  I used Vincent E. Perriello's document,
  50.     'Fundamentals of  FOSSIL  implementation  and use',  Draft  version 3,
  51.     March 7, 1987.   Gateway determines  the UART  port  address from  the
  52.     RS_232_BASE table.  This is located  in the BIOS data  area at address
  53.     0040:0000.  Gateway only  does this when  the Direct  write option has
  54.     been specified.  Enough tech stuff...
  55.  
  56.  
  57.  
  58.  
  59.                               CHANGES & ADDITIONS
  60.                               -------------------
  61.  
  62.         With the release of  version 2.00 of  Gateway several changes have
  63.     been made.  The most important addition is the ability to use a Fossil
  64.     driver for input/ouput.  This makes Gateway very generic.  The program
  65.     is  now one file that is  configured with command line arguments.  The
  66.     support of COM1 through COM4 has been added.  Tabs are expanded on the
  67.     system screen.  Some of the code  has been optimized  ( but I doubt if
  68.     you will notice ).  That is all I can think of at the moment...
  69.  
  70.  
  71.  
  72.                                  INSTRUCTIONS
  73.                                  ------------
  74.  
  75.         The Gateway program is  implemented as a device driver.  It should
  76.     be loaded  with  your CONFIG.SYS file.  An example line  from a CONFIG
  77.     file is shown below :
  78.  
  79.     DEVICE=[drive:][path\]Gateway.sys
  80.  
  81.         This example would load Gateway, defaulting to a Fossil driver for
  82.     input/output onto COM line 1. The configuration of Gateway may also be
  83.     changed with command line arguments. The arguments accepted are listed
  84.     below :
  85.  
  86.  
  87.                    -F           { Use Fossil driver (default)   }
  88.                    -D           { Use Direct port writes        }
  89.  
  90.                    -1           { Use COM line 1    (default)   }
  91.                    -2           { Use  '   '   2                }
  92.                    -3           { Use  '   '   3                }
  93.                    -4           { Use  '   '   4                }
  94.  
  95.  
  96.     If no arguments are given, Gateway will default to -F -1 (Fossil driver
  97.     on COM1).  The -F and -D  option are  mutually exclusive as are the COM
  98.     line  values.  These arguments are  included on  the line  used to load
  99.     Gateway.  Here are  several  examples that  could be  used in  your own
  100.     Config.sys file :
  101.  
  102.  
  103.     DEVICE=C:\GATEWAY.SYS -F -2         { Loads Gateway using Fossil    }
  104.                                         { driver for COM line 2         }
  105.  
  106.     DEVICE=B:\SYS\GATEWAY.SYS -4 -F     { Loads Gateway using Fossil    }
  107.                                         { driver for COM line 4         }
  108.  
  109.     DEVICE=C:\GATEWAY.SYS -D -2         { Loads Gateway using Direct    }
  110.                                         { port writes on COM line 2     }
  111.  
  112.     DEVICE=GATEWAY.SYS -D -3            { Load Gateway using Direct     }
  113.                                         { port writes on COM line 3     }
  114.  
  115.     The order of  the arguments does  not matter.  Drive and path are also
  116.     optional.  After Gateway is loaded, it determines what COM line it has
  117.     been  installed for.  It  then sets  its device  name according to the
  118.     line chosen.  The names for each line are shown below :
  119.  
  120.                         GATE1           { COM line 1 }
  121.                         GATE2           { COM line 2 }
  122.                         GATE3           { COM line 3 }
  123.                         GATE4           { COM line 4 }
  124.  
  125.     Simple and  original convention, eh?   This allows you to install more
  126.     than one  copy of  Gateway  for separate  COM lines.  A  note for PCjr
  127.     owners.  The external serial port should be addressed as COM1 when the
  128.     Internal Modem is  not installed.  When installed,  the Internal Modem
  129.     is addressed as COM1 and the external serial port as COM2.
  130.  
  131.         Once loaded,  the driver  may be  activated in two  possible ways.
  132.     The first method uses  the DOS command CTTY.  This command changes the
  133.     standard input  and output console.  An explanation of it may be found
  134.     in your DOS manual.  This command is  executed from the DOS prompt.  A
  135.     few example activations of Gateway are shown below :
  136.  
  137.  
  138.                 C>CTTY GATE1            { Make Gateway COM1 the standard }
  139.                                         { console driver.                }
  140.  
  141.                 A>CTTY GATE3            { Same as above except for a     }
  142.                                         { COM3 version of Gateway.       }
  143.  
  144.         This will  cause all standard i/o to be  directed through Gateway.
  145.     Notice that the  name after the CTTY command is the device name of the
  146.     Gateway  program.  When finished  using  Gateway, enter  the following
  147.     command at the prompt :
  148.  
  149.                                 CTTY CON
  150.  
  151.     When this is  entered, DOS will restore the screen and keyboard as the
  152.     standard input and output devices.
  153.  
  154.         The second  method for using the driver involves using the DOS i/o
  155.     re-direction  symbols.  These are  explained in  the DOS manual.  With
  156.     this method, the driver is only activated  during the execution of the
  157.     program being re-directed.  An example :
  158.  
  159.                         A>COMMAND < GATE2 > GATE2
  160.  
  161.     When this  command is  entered at the  DOS prompt, several things take
  162.     place. First, DOS determines  that all input and output will come from
  163.     Gateway (COM2).  Then, the second  Command processor  (COMMAND.COM) is
  164.     loaded.  Any  input  or output will  now be  sent through the  Gateway
  165.     driver.  The Sysop will also be a